home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms_w / wrcprs14.zip / RCP.DOC < prev    next >
Text File  |  1995-01-17  |  11KB  |  279 lines
  1.   Winsock RCP                                        Version 1.4
  2.   Copyright 1994 Denicomp Systems
  3.   All Rights Reserved
  4.   
  5.   
  6.   DESCRIPTION
  7.   -----------
  8.   
  9.   Winsock RCP ("Remote Copy") copies files between a PC and a remote host or
  10.   between two remote hosts.  It is similar to the Unix utility of the same name.
  11.  
  12.   A "remote host" must be a system running the rshd server process
  13.   (i.e. a Unix system).  You cannot RCP from or to another PC, only
  14.   to or from your own PC to a system running rshd.
  15.   
  16.  
  17.   REQUIREMENTS
  18.   ------------
  19.  
  20.   Winsock RCP requires a PC running Windows 3.1 or higher and a Windows
  21.   Sockets compatible TCP/IP stack.
  22.  
  23.  
  24.   SYNTAX
  25.   ------
  26.   
  27.    rcp [-abmrw] [[User@][Host:]]{File | Dir} ... [[User@][Host:]]{File | [Dir]}
  28.  
  29.  
  30.   PARAMETERS
  31.   ----------
  32.   
  33.   User@   (optional)  Specifies the user name to be used at the remote
  34.           host.  If this prefixes the Host: parameter, this user name
  35.           overrides the user name of the PC.
  36.  
  37.   Host:   Specifies the host name of the remote host.  This is not
  38.           required if the file or directory referenced is on the PC.
  39.           This host must be a system running the rshd server process.
  40.           That is, you cannot use the host name of another PC running
  41.           Windows or MS-DOS.
  42.  
  43.   File      Specifies the file name of the source or destination file.  You
  44.           may use wildcard characters to copy multiple source files.  You
  45.           may also specify multiple source files individually by separating
  46.           the names with spaces.
  47.  
  48.   Dir     Specifies the file name of the source or destination directory.
  49.           
  50.  
  51.   
  52.   The Host: parameter is required for either the source file/directory or
  53.   the destination file/directory.  Copying between two remote hosts is
  54.   permitted by specifying a Host: for both the source and destination.
  55.  
  56.   If a remote host name is not specified for either the source or the
  57.   destination, you will receive an error.  Use the COPY command instead.
  58.   Do not use the Host: parameter when referencing local files; this will
  59.   not work.
  60.   
  61.   If the Host is prefixed by the User@ parameter, that name is used as the
  62.   user name at the remote host.  If the User@ parameter is not used, the
  63.   local user name is used at the remote host.
  64.  
  65.   The local user name is determined by first looking in the file WIN.INI
  66.   in the Windows directory.  If this file contains a section named "[RCP]"
  67.   and contains an entry named "User" in that section, the name specified
  68.   there will be used as the local user name.  For example, WIN.INI would
  69.   contain:
  70.  
  71.      [RCP]
  72.      User=joe
  73.  
  74.   If this appeared in WIN.INI, the local user name would be "joe" and
  75.   Winsock RCP would use this name at the remote host.
  76.  
  77.   If this section does not appear in WIN.INI, Winsock RCP uses the Computer
  78.   Name specified in the Windows for Workgroups Network Setup (found on the
  79.   Control Panel).  This name is converted to lowercase characters and Winsock
  80.   RCP uses this name at the remote host.  Therefore, if no user name is
  81.   specified in WIN.INI, the Computer Name of the PC must be set up as a
  82.   valid user on the remote host, in addition to being included in the
  83.   remote host's /etc/hosts.equiv file.
  84.  
  85.   (If you are not using Windows for Workgroups and your network does not
  86.   provide the services that Windows for Workgroups provides, you must use
  87.   WIN.INI to specify the user name or always use the User@ parameter.)
  88.  
  89.   If a full directory path is not specified for a remote host, the path
  90.   begins at the user's home directory.  That is, if the file/directory
  91.   name specified after the Host: parameter does not begin with a slash (/),
  92.   it is assumed to reference a file/directory in the user's home directory.
  93.  
  94.   For example, the file "joe@remhost:file.txt" refers to the file "file.txt"
  95.   in the home directory of the user "joe" on the host "remhost".
  96.  
  97.   Filenames may contain either slashes (/) or backslashes (\) as directory
  98.   separators, for either the host file/directory or file/directories on the
  99.   PC.  They will be converted to the appropriate separator.
  100.  
  101.   You can copy multiple files by using wildcard characters, such as * or ?.
  102.  
  103.   You can also copy multiple source files by separating them with spaces.
  104.   If the source files reside on the remote host, you must specify the Host:
  105.   (and optionally the User@) parameter for each file.
  106.  
  107.   If you copy multiple source files with wildcard characters or by specifying
  108.   individual filenames, the destination must be a directory.
  109.  
  110.   Note that a colon (:) terminates the host name.  This causes a problem
  111.   when filenames on the PC require a drive letter (e.g. A:).  If a file
  112.   name specification begins with one character between A and Z and is
  113.   followed by a colon (:), Winsock RCP will interpret this as a drive letter
  114.   instead of a host name.  This means that Winsock RCP cannot handle one
  115.   character host names.
  116.  
  117.   The destination cannot contain only a drive specification (e.g. A:).  It
  118.   must also include a filename or a directory name.  If the destination is
  119.   the current directory on the drive, use "." (e.g. A:.).
  120.  
  121.   FLAGS
  122.   -----
  123.  
  124.   -a    ASCII conversion.  For file(s) transferred to the remote host, all
  125.         sequences of CR/NL (ASCII 13/10) will be converted to NL (ASCII 10).
  126.         This is the standard Unix text file format.  For file(s) transferred
  127.         from the remote host to the PC, a CR (ASCII 13) will be added before
  128.         every NL (ASCII 10) if that NL is not already preceeded by a CR.  This
  129.         is the standard MS-DOS text file format.  Without the -a flag, files
  130.         are transferred with no translation.
  131.  
  132.   -b    Binary transfer.  File(s) are transferred with no modifications.  This
  133.         is the default, so this flag is not necessary if you want a binary
  134.         transfer.  It is provided for command line compatibility with other
  135.         RCP commands from other vendors.
  136.   
  137.   -r    Recursively copies, for directories only, each file and
  138.         subdirectory in the source directory into the destination directory.
  139.   
  140.   -m    *Run Minimized.  Normally, Winsock RCP will display a window showing
  141.         progress and any possible error messages.  With -m, Winsock RCP will
  142.         only display a minimized icon while running.  This is useful for
  143.         software developers who wish to call Winsock RCP transparently from
  144.         within their software.
  145.  
  146.   -w    Wait for Return key.  This waits for you to press the Return
  147.         key after the file(s) are copied so you can view the list of files
  148.         copied and any error messages from the remote hots.  If you are
  149.         copying multiple files and the list scrolls the window, you can
  150.         use the scrollbars to review the scrolled information.
  151.   
  152.         * - This option is only available in the registered version.
  153.  
  154.  
  155.   NOTES FOR FLAGS
  156.   ---------------
  157.  
  158.   Specify all flags separately; do not combine flags.  For example, do not use
  159.   "-amw"; use "-a -m -w" instead.
  160.  
  161.   The -a flag translates the file regardless of its actual contents.  For
  162.   example, if you transfer a non-text file using -a, it will be modified as
  163.   if it were a text file.
  164.  
  165.   If you use the -a flag and you transfer multiple files, all files will be
  166.   translated as ASCII files.
  167.  
  168.   Using the -a flag to transfer files TO the remote host will slow the operation
  169.   of Winsock RCP somewhat because it must read each file twice.  It reads the
  170.   file once to calculate the new translated file size, then reads it again to
  171.   transfer the data.  This is because the RCP protocol requires that the exact
  172.   file size be transmitted before the actual data in the file is sent.  Without
  173.   the -a option, the file size can be found by examining the file's directory
  174.   entry, but with the -a, the file's contents must be examined to determine the
  175.   size after CR/NL combinations are replaced with NL.
  176.  
  177.   The -a flag will also slow Winsock RCP when transferring files FROM the
  178.   remote host, but only slightly.
  179.  
  180.   If transmission speed is critical, consider using utilities to translate the
  181.   text files after they are transferred.
  182.  
  183.  
  184.   SECURITY 
  185.   --------
  186.   
  187.   The local user name determines the file access privileges Winsock RCP
  188.   uses at that remote host.  This name also determines the ownership and
  189.   access modes of the destination file or files.  The remote host allows
  190.   access if one of the following conditions is satisfied:
  191.   
  192.   * The name of the local host is listed as an equivalent host in the
  193.     /etc/hosts.equiv file on the remote host.
  194.  
  195.     The method of specifying the local host name is determined by the
  196.     particular TCP/IP stack you are using.
  197.     
  198.   * If the local host is not in the /etc/hosts.equiv file, the user's home
  199.     directory on the remote host must contain a .rhosts file that lists the
  200.     local host and local user name.
  201.   
  202.   * The user's login on the remote host does not require a password.
  203.  
  204.   The .rhosts file in the user's home directory must be owned by either
  205.   the user specified or "root", and only the owner should have read and write
  206.   access.
  207.  
  208.  
  209.   EXAMPLES
  210.   --------
  211.   
  212.   * To copy a file from the PC to a remote host, use:
  213.   
  214.             rcp localfile remhost:/u/joe
  215.   
  216.     The file localfile is copied from the PC to the remote host remhost and
  217.     placed in the directory /u/joe.
  218.  
  219.   
  220.   * To copy a file from the remote host to the PC, use:
  221.   
  222.             rcp remhost:/u/joe/remfile \lists\remfile
  223.   
  224.     The file remfile is copied from the remote host remhost to the file
  225.     remfile in the directory \lists on the PC.
  226.  
  227.   
  228.   * To copy a remote file from one remote host to another remote host, use: 
  229.   
  230.             rcp host1:/u/joe/xfile host2:/u/fred/yfile
  231.   
  232.     The file /u/joe/xfile on host1 is copied to the file /u/fred/yfile on
  233.     the remote host host2.
  234.   
  235.  
  236.   * To copy all of the files in the directory \docs to the a remote host:
  237.  
  238.              rcp -a -w \docs\*.* remhost:/u/docs
  239.  
  240.     All of the files in \docs are copied to the directory /u/docs on the
  241.     remote host remhost.  The files are converted from the MS-DOS text file
  242.     format to the Unix text file format using the "-a" flag.  As the files
  243.     are transferred, their names will display on the screen.  The "-w" option
  244.     tells Winsock RCP to wait for you to press Enter after the files are
  245.     transferred so you can examine the list.
  246.  
  247.  
  248.   * To copy the file from a remote host to the diskette in drive A: on the PC:
  249.  
  250.              rcp mary@remhost:resume.doc a:.
  251.  
  252.     This will copy the file resume.doc from the user mary's home directory
  253.     (since no starting directory was given after the host) to the same
  254.     name on the diskette in drive A: on the PC.  Note the "." after the
  255.     colon of the drive letter.  This refers to the current directory on the
  256.     A: drive, since a destination filename or directory name is required.
  257.  
  258.  
  259.   * To send the entire directory tree from the PC to a remote host, use:
  260.   
  261.              rcp -r \share joe@remhost:
  262.   
  263.     The directory \share is copied from the PC to the home directory of joe
  264.     on the remote host remhost.
  265.  
  266.  
  267. SUPPORT
  268. -------
  269.  
  270. Support is available via U.S. Mail and Compuserve/Internet.
  271.  
  272. Denicomp Systems
  273. P.O. Box 731
  274. Exton, PA  19341
  275.  
  276. Compuserve: 71612,2333
  277. Internet:   71612.2333@compuserve.com
  278.  
  279.